Message Definitions

The following messages are known and used by StageRace for communicating with external software through the StageRace Messaging protocol.

Note that numerous parameters are divided in two 16-bits parts.

We recommend that values indicated as 'not used' are set to NULL.

Client to StageRace

To Arrival Dialog

1. WM_STAGERACE_AR_SETCOMP

Parameters:

• First parameter (W): upper bytes: rank [unsigned short int]
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): time [ms] [unsigned int]

Description: Request to the arrival dialog to submit the competitor in the arrival list

Note 1: For time trials: the time is the gross time
Note 2: For time trials: the rank is ignored
Note 3: Illegal competitors are ignored without further notice

Return message: none

2. WM_STAGERACE_AR_DECLASSCOMP

Parameters:

• First parameter (W): upper bytes: not used
• First parameter (W): lower bytes: StaNo [unsigned short int]
• Second parameter (L): not used

Description: Request to the arrival dialog to declass the competitor

Note: Illegal competitors are ignored without further notice

Return message: none

3. WM_STAGERACE_AR_GETCOMPFROMSTANO

Parameters:

• First parameter (W): upper bytes: not used
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): requesting window [HWND]

Description: Request to the arrival dialog to send this competitor's rank and race time

Return message: WM_STAGERACE_AR_INFOCOMP

4. WM_STAGERACE_AR_GETCOMPFROMTIME

Parameters:

• First parameter (W): time [ms] [unsigned int]
• Second parameter (L): requesting window [HWND]

Description: Request to the arrival dialog to send rank and race time of the first competitor with a better time than provided

Note: For time trials: the time is the net time

Return message: WM_STAGERACE_AR_INFOCOMP

5. WM_STAGERACE_AR_GETCOMPFROMRANK

Parameters:

• First parameter (W): upper bytes: rank [unsigned short int]
• First parameter (W): lower bytes: not used
• Second parameter (L): requesting window [HWND]

Description: Request to the arrival dialog to send start no. and race time of the competitor with the rank as provided

Return message: WM_STAGERACE_AR_INFOCOMP

6. WM_STAGERACE_TT_GETSTARTTIME

Parameters:

• First parameter (W): upper bytes: not used
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): requesting window [HWND]

Description: Request to the time trial arrival dialog to send the start time of a competitor

Return message: WM_STAGERACE_TT_INFOCOMP

To StageRace View

WM_STAGERACE_GETCOMPFROMSTANO

Parameters:

• First parameter (W): upper bytes: not used
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): requesting window [HWND]

Description: Request to the document to send this competitor's name, team and team code

Return message: WM_STAGERACE_COMP

StageRace to client

From Arrival Dialog

1. WM_STAGERACE_AR_INFOCOMP

Parameters:

(sent to the requesting window)

• First parameter (W): upper bytes: rank [unsigned short int]
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): time [ms] [unsigned int]

Description: Sends the arrival information of a particular competitor in the arrival list

Note 1: In case the requested competitor/rank/time is not available, start no. will be set to -1 while other fields do not necessarily consist of any valid information

Note 2: For time trials: the time is the net time

Return message: none

2. WM_STAGERACE_TT_INFOCOMP

Parameters:

(sent to the requesting window)

• First parameter (W): upper bytes: not used, NULL
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): time [ms] [unsigned int]

Description: Sends the starting time of a particular competitor in the available/arrival list

Note: In case the requested competitor/rank/time is not available, start no. will be set to -1 while other fields do not necessarily consist of any valid information

Return message: none

From StageRace View

WM_STAGERACE_COMP

Parameters:

• First parameter (W): upper bytes: name [atom identifier]
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): upper bytes: team [atom identifier]
• Second parameter (L): lower bytes: team code [atom identifier]

Description: Sends the global information of a particular competitor in the document

Note 1: Text strings are provided as atoms. Receiving window is responsible for cleaning up atoms
Note 2: In case the requested competitor is not available, start no. will be set to -1 while no atoms being created thus the other fields not necessarily con-sisting of any valid information
Note 3: Refer to Message extensions (atoms) for information on the atoms that are used for this message

Return message: none

Non-StageRace

For communication between the Time Trial Controller and the Score Board Controller from Totaal Software, the following two additional messages are in order.

These messages do not apply to StageRace.

1. WM_TTC_GETTIME

Parameters:

• First parameter (W): not used, NULL
• Second parameter (L): requesting window [HWND]

Description: Request to the Time Trial Controller to send the current time in the race

Return message: WM_TTC_TIME

2. WM_TTC_TIME

Parameters:

• First parameter (W): upper bytes: not used, NULL
• First parameter (W): lower bytes: start no. [unsigned short int]
• Second parameter (L): time [ms] [unsigned int]

Description: Sends the arrival time and possible start no. of an arrived competitor from the Time Trial Controller to the Score Board Controller

Note: Start no. may be zero in which case the message contains the current time

Return message: none